←Select platform

SetRow(int,byte[],int,int) Method

Summary
Copies one or more rows of image data to this RasterImage.
Syntax
C#
Objective-C
C++/CLI
Java
Python
public int SetRow( 
   int row, 
   byte[] buffer, 
   int bufferIndex, 
   int bufferCount 
) 
- (NSInteger)setRow:(NSInteger)row  
             buffer:(const unsigned char *)buffer  
        bufferCount:(unsigned long)count  
              error:(NSError **)error 
public long setRow( 
  int row,  
  byte[] buffer,  
  int bufferIndex,  
  long bufferCount 
) 
public: 
int SetRow(  
   int row, 
   array<byte>^ buffer, 
   int bufferIndex, 
   int bufferCount 
)  
def SetRow(self,row,buffer,bufferIndex,bufferCount): 

Parameters

row
The number of the row to update. The first row is 0, and the last row is 1 less than the image height.

buffer
Buffer containing the image data. The data is copied exactly as it is stored in the buffer. The buffer should contain uncompressed data regardless of whether the image is compressed or not.

bufferIndex
The zero-based index into the  buffer where the set operation should start.

bufferCount
Number of bytes to set. Use the BytesPerLine property of this RasterImage to determine the byte count of each line.

Return Value

The number of bytes copied.

Remarks

The image memory must be locked when you use this method. Normally, you can call Access to lock the memory before starting an operation that uses this method. Then call Release when the operation is finished.

You can use the BitsPerPixel property of the image to determine the number of bytes to set the  bufferCount parameter. If the image is 8-bit then each byte is an index to the palette. If the image is a 24-bit image, then each three bytes represents one pixel element. Color order is determined by the Order property of the RasterImage object. This value can be RasterByteOrder.Rgb, RasterByteOrder.Bgr, or RasterByteOrder.Romm.

Note: To calculate the correct size for a single row of image data:

  • Windows-based platforms: (((Width * BitsPerPixel) + 31) >> 3)) & ~3
  • Unix-based platforms (Linux, Android, OSX, iOS): (((Width * BitsPerPixel) + 7) / 8)

RasterByteOrder.Gray is only valid for 12 and 16-bit grayscale images. Support for 12 and 16-bit grayscale images is only available in the Document/Medical Imaging editions.

For more information, refer to Introduction to Image Processing With LEADTOOLS.

Example
C#
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Dicom; 
using Leadtools.Drawing; 
using Leadtools.Controls; 
using Leadtools.Svg; 
 
 
public void GetRowTest() 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
	RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1.CMP")); 
 
	byte[] row1 = new byte[image.BytesPerLine]; 
	byte[] row2 = new byte[image.BytesPerLine]; 
 
	image.Access(); 
	for (int y = 0; y < image.Height / 2; y++) 
	{ 
		image.GetRow(y, row1, 0, row1.Length); 
		image.GetRow(image.Height - y - 1, row2, 0, row2.Length); 
 
		image.SetRow(y, row2, 0, row2.Length); 
		image.SetRow(image.Height - y - 1, row1, 0, row1.Length); 
	} 
	image.Release(); 
 
	codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1_getrow.BMP"), RasterImageFormat.Bmp, 0); 
 
	image.Dispose(); 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
} 
Requirements

Target Platforms

Help Version 22.0.2023.5.16
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.